home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINPROGS / WINSRC20.ZIP / WINSRC.DOC < prev   
Text File  |  1990-10-20  |  4KB  |  72 lines
  1. Let's start with the caveats:
  2.  
  3. 1) you need Microsoft C 5.1 or 6.0 (I use 6.0) and the Microsoft
  4. Windows 3.0 SDK to rebuild WINFRACT from this ZIP file.
  5.  
  6. 2) There are a lot of "common modules" between Fractint-for-Windows and
  7. Fractint-for-DOS, but they are *not* currently in synch.  By that, we
  8. mean that CALCFRAC.C as distributed with version 2.0 of Fractint-for-Windows
  9. is *not* the same file as CALCFRAC.C distributed with version 14.0 of
  10. Fractint-for-DOS (lots of little changes had to be made to get it to
  11. work in both the FFD and FFW environments), and probably won't quite
  12. match the one in version 15.0 of FFD.  Just as soon as things settle
  13. down <grin>, we'll start distributing "synched" sources of both FFD and FFW.
  14.  
  15. 3) The MAKEFRAC.BAT file references a program called VIDRAM, which is
  16. distributed with Quarterdeck's QEMM package and as such is *not*
  17. included with this ZIP file.  VIDRAM temporarily ('VIDRAM ON') converts
  18. your EGA or VGA adapter's memory to DOS memory, so that you effectively
  19. have a 736K machine that only runs in text mode - 'VIDRAM OFF' puts 
  20. everything back at the end.  VIDRAM is not strictly required for the
  21. compilation process to work, but it sure speeds up the LINK step.  That's
  22. "speeds up" in that the LINK step only takes 15 minutes on my 16MHZ PS/2
  23. model 80 rather than 30 minutes.  The LINK step itself is pulled out
  24. of the "make" process and into MAKEFRAC.BAT just to give LINK as much RAM 
  25. as possible.
  26.  
  27. 4) Comments?  I got this thing ported in four months of my spare time
  28. and you expected me to take the time to put *comments* in the source
  29. code?
  30.  
  31. ---------
  32.  
  33. How this program works:
  34.  
  35. First of all, we got lucky.  Fractint-for-DOS has, for some time, been
  36. structured such that the working modules periodically call a routine 
  37. called 'keypressed()'.  That routine both lets the calling program know if
  38. there is a keypress or mouse movement waiting that is of interest to the
  39. calling routine, and it handles the help (F1) and status (TAB) routines in a
  40. manner invisible to the calling routine.
  41.  
  42. In the Windows environment, 'keypressed()' performs a 'peekmessage()' 
  43. function, checking for and processing any user activity, and returns
  44. a value indicating that either nothing of interest has happened, or that
  45. the calling program should terminate and return to the main routine which
  46. will actually decide what to do.
  47.  
  48. Aside from the routines that are taken directly from Fractint-for-DOS,
  49. the following routines are Windows-specific:
  50.  
  51. winsrc.doc      - you're reading it right now
  52. makefrac.bat    - run this routine to make a new version of WINFRACT
  53. winfract        - the WINFRACT "make" file
  54. winfract.def    - the WINFRACT "def" file
  55. winfract.rc     - the WINFRACT "resource compiler" file
  56. winfract.ico    - the WINFRACT "icon"
  57. winfract.rtf    - the source for the HELP text
  58. winfract.hpj    - the project for the HELP text
  59. winfract.h      - generic WINFRACT include file
  60. select.h        - used by the zoom-box routines (stolen from the Windows SDK)
  61. winfract.lnk    - the list of files required by the LINK step 
  62. winlib.lst      - used to build a LIB of FFD routines
  63. winfract.c      - the main WINFRACT routine
  64. dialog.c        - the first of two dialog modules
  65. dialog2.c       - the second of two dialog modules
  66. windos.c        - Windows routines that fake DOS routines
  67.                   (routines such as 'keypressed()' are in here)
  68. mainfrac.c      - the main "Fractint" driver routine (called by winfract.c)
  69. select.c        - Zoom-box routines (stolen from the Windows SDK)
  70. wgeneral.asm    - WINFRACT assembler code
  71. wgeneral.obj    - compiled version of same (so you won't need an assembler)
  72.